/*-------------------------------------------------------------------------
 *
 * pg_iovec.h
 *	  用于向量 I/O 函数的头文件，可替代 <sys/uio.h>。
 *
 * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 * src/include/port/pg_iovec.h
 *
 *-------------------------------------------------------------------------
 */
#ifndef PG_IOVEC_H
#define PG_IOVEC_H

#include <limits.h>

#ifdef HAVE_SYS_UIO_H
#include <sys/uio.h>
#endif

/* 如果 <sys/uio.h> 缺失，定义我们自己的 POSIX 兼容的 iovec 结构。 */
#ifndef HAVE_SYS_UIO_H
struct iovec
{
	void	   *iov_base;
	size_t		iov_len;
};
#endif

/*
 * 如果 <limits.h> 没有定义 IOV_MAX，则定义我们自己的值。
 * POSIX 要求至少为 16。
 */
#ifndef IOV_MAX
#define IOV_MAX 16
#endif

/* 定义一个合理的最大值，确保在堆栈上使用安全。 */
#define PG_IOV_MAX Min(IOV_MAX, 32)

#if HAVE_DECL_PREADV
#define pg_preadv preadv
#else
extern ssize_t pg_preadv(int fd, const struct iovec *iov, int iovcnt, off_t offset);
#endif

#if HAVE_DECL_PWRITEV
#define pg_pwritev pwritev
#else
extern ssize_t pg_pwritev(int fd, const struct iovec *iov, int iovcnt, off_t offset);
#endif

#endif							/* PG_IOVEC_H */
